home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 414_02 / portable / winch.c < prev    next >
Encoding:
C/C++ Source or Header  |  1993-06-17  |  1.8 KB  |  58 lines
  1. #define    CURSES_LIBRARY    1
  2. #include <curses.h>
  3. #undef    winch
  4.  
  5. #ifdef PDCDEBUG
  6. char *rcsid_winch = "$Header: C:\CURSES\portable\RCS\winch.c 2.1 1993/06/18 20:21:40 MH Rel MH $";
  7. #endif
  8.  
  9.  
  10.  
  11.  
  12. /*man-start*********************************************************************
  13.  
  14.   winch()    - return character from window
  15.  
  16.   X/Open Description:
  17.      The character at the current position in the named window is
  18.      returned.  If any attributes are set for that position, their
  19.      values will be bitwise-OR'ed into the value returned.  The
  20.      pre-defined constants A_CHARTEXT and A_ATTRIBUTES, defined in
  21.      <curses.h>, can be used with the & (bitwise-AND) operator to
  22.      extract the character or attribute alone.
  23.  
  24.      NOTE: inch(), winch(), mvinch() and mvwinch() are macros.
  25.  
  26.   PDCurses Description:
  27.      There is no additional PDCurses functionality.  This routine
  28.      is here as a documentation placeholder.  No code will be
  29.      executed in this module, unless the user #undefs winch.
  30.  
  31.   X/Open Return Value:
  32.      Upon successfull completion, the inch(), mvinch(), mvwinch(),
  33.      and winch() functions return the character at the selected
  34.      position.  Otherwise, the mvinch() and mvwinch() functions
  35.      return ERR.
  36.  
  37.   PDCurses Errors:
  38.      It is an error to call this function with a NULL window pointer.
  39.      It is also an error to address a position that is outside the
  40.      bounds of the specified window.
  41.  
  42.   Portability:
  43.      PDCurses    chtype winch( WINDOW* win );
  44.      X/Open Dec '88    chtype winch( WINDOW* win );
  45.      BSD Curses    
  46.      SYS V Curses    int winch( WINDOW* win );
  47.  
  48. **man-end**********************************************************************/
  49.  
  50. chtype    winch(WINDOW *win)
  51. {
  52. #ifdef PDCDEBUG
  53.     if (trace_on) PDC_debug("winch() - called\n");
  54. #endif
  55.  
  56.     return( win->_y[win->_cury][win->_curx] );
  57. }
  58.